home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / admin.fmt / fsmake.man < prev    next >
Encoding:
Text File  |  1991-06-14  |  9.7 KB  |  267 lines
  1.  
  2.  
  3.  
  4. FSMAKE                    User Commands                    FSMAKE
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NNAAMMEE
  11.      fsmake - Create a file system on a disk partition.
  12.  
  13. SSYYNNOOPPSSIISS
  14.      ffssmmaakkee --ddeevv _d_e_v_i_c_e --ppaarrtt _p_a_r_t_i_t_i_o_n [[_o_p_t_i_o_n_s]
  15.  
  16. OOPPTTIIOONNSS
  17.      --ddeevv _d_e_v_i_c_e   _D_e_v_i_c_e is the root  name  of  a  device,  i.e.
  18.                    rxy0, rsd1, rsb0
  19.  
  20.      --ppaarrtt _p_a_r_t_i_t_i_o_n
  21.                    _P_a_r_t_i_t_i_o_n is a letter indicating a  partition,
  22.                    i.e. a, b, c, d, e, f, g.
  23.  
  24.      --ddeevvDDiirr _d_e_v_D_i_r
  25.                    _D_e_v_D_i_r is an alternate directory in  which  to
  26.                    find  the  device  file named by concatenating
  27.                    _d_e_v_i_c_e and _p_a_r_t_i_t_i_o_n.  The  default  directory
  28.                    name is ``/dev``.
  29.  
  30.      --iinniittiiaallPPaarrtt _f_i_r_s_t_P_a_r_t_N_a_m_e
  31.                    _f_i_r_s_t_P_a_r_t_N_a_m_e is the name of the initial  par-
  32.                    tition  on  the disk which contains basic disk
  33.                    geometry information.  The default  is  parti-
  34.                    tion ``a''.
  35.  
  36.      --wwrriittee        Write the disk.  The default is to  not  write
  37.                    the disk.
  38.  
  39.      --oovveerrllaapp      Overlap filesystem blocks across  track  boun-
  40.                    daries. The default is to not overlap blocks.
  41.  
  42.      --rraattiioo        Ratio  of  Kbytes  to  file  descriptors.  The
  43.                    default is 4.
  44.  
  45.      --tteesstt         Don't write to the disk. This is the default.
  46.  
  47.      --ssccssii         Compute the disk geometry for a SCSI disk. The
  48.                    geometry  will  be laid out to maximize usable
  49.                    storage.
  50.  
  51.      --nnoossccssii       Compute the disk geometry for a non-SCSI disk.
  52.                    The  geometry  will  be  laid  out to maximize
  53.                    transfer bandwidth.  The file system currently
  54.                    doesn't  do  anything  intelligent when laying
  55.                    out a file, so this  option  is  probably  not
  56.                    worth anything.
  57.  
  58.      --hhoosstt _h_o_s_t_I_D  Sets the host id field in the  domain  header.
  59.                    The default is to use the local host id if the
  60.  
  61.  
  62.  
  63. Sprite v.1.0         Printed:  June 13, 1991                    1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. FSMAKE                    User Commands                    FSMAKE
  71.  
  72.  
  73.  
  74.                    device server is the local host, otherwise use
  75.                    the  device server's id.  _H_o_s_t_I_D is either the
  76.                    name or Sprite id of the machine to which  the
  77.                    domain will be attached.
  78.  
  79.      --bboooott _b_o_o_t_S_e_c_t_o_r_s
  80.                    Number of sectors in  the  root  partition  to
  81.                    reserve for the boot program.
  82.  
  83.      --rreeppaarrttiittiioonn  This option will change  the  partitioning  of
  84.                    the  disk.  DO  NOT USE IF THE DISK CONTAINS A
  85.                    FILESYSTEM YOU WISH TO KEEP.  Use  the  --ppaarrtt--
  86.                    ddiisskkttaabb  option to use the partitioning infor-
  87.                    mation in the disktab file, otherwise use  the
  88.                    --ssiizzee  option  to  set the size of the current
  89.                    partition.
  90.  
  91.      --ppaarrttddiisskkttaabb  Use  in  conjunction  with  the   --rreeppaarrttiittiioonn
  92.                    option  to  set the disk partitioning from the
  93.                    disktab file.
  94.  
  95.      --ssiizzee _p_e_r_c_e_n_t_a_g_e
  96.                    Use  in  conjunction  with  the   --rreeppaarrttiittiioonn
  97.                    option to specify the size of the current par-
  98.                    tition as a percentage of the total disk size.
  99.                    _P_e_r_c_e_n_t_a_g_e is an integer from 0-100.
  100.  
  101.      --rreeccoonnffiigg     Reconfigures the basic disk geometry.  DO  NOT
  102.                    USE IF THE DISK CONTAINS A FILESYSTEM YOU WISH
  103.                    TO KEEP. If the disk is a non-scsi  disk  then
  104.                    you   must  also  specify  the  --ccoonnffiiggddiisskkttaabb
  105.                    option which causes the disk  geometry  to  be
  106.                    read  from the disktab file.  If the disk is a
  107.                    scsi disk then you may omit the --ccoonnffiiggddiisskkttaabb
  108.                    option.   _F_s_m_a_k_e will then invent a configura-
  109.                    tion that minimizes wasted disk space.
  110.  
  111.      --ccoonnffiiggddiisskkttaabb
  112.                    Use in conjunction with the  --rreeccoonnffiigg  option
  113.                    to  set the disk configuration (geometry) from
  114.                    the disktab file.
  115.  
  116.      --ddiisskkttaabbNNaammee _f_i_l_e_n_a_m_e
  117.                    Specify the  disktab  file.   The  default  is
  118.                    /_e_t_c/_d_i_s_k_t_a_b.
  119.  
  120.      --ddiisskkttyyppee _t_y_p_e
  121.                    Specify the type of disk.  This _t_y_p_e parameter
  122.                    must  be the type of disk found in the disktab
  123.                    file.  This option must be present in order to
  124.                    use the disktab file.
  125.  
  126.  
  127.  
  128.  
  129. Sprite v.1.0         Printed:  June 13, 1991                    2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. FSMAKE                    User Commands                    FSMAKE
  137.  
  138.  
  139.  
  140.      --llaabbeellttyyppee _t_y_p_e
  141.                    Type of label  to  write  on  the  disk.   The
  142.                    default   is   to   write  whatever  label  is
  143.                    appropriate for the machine on which ffssmmaakkee is
  144.                    run.
  145.  
  146.      --ddiirr _d_i_r_e_c_t_o_r_y
  147.                    Copy the specified directory  into  the  newly
  148.                    created filesystem.
  149.  
  150. _________________________________________________________________
  151.  
  152.  
  153. DDEESSCCRRIIPPTTIIOONN
  154.      FFssmmaakkee will create a Sprite filesystem on  a  partition.  It
  155.      has  a large number of options and is intended to be invoked
  156.      from a shell script.  FFssmmaakkee's basic function is to create a
  157.      filesystem  out  of  an entire partition by initializing the
  158.      the file descriptor bitmap, data  block  bitmap  and  domain
  159.      header,  and  creating  the root and lost+found directories.
  160.      If you desire you can copy a directory  tree  into  the  new
  161.      filesystem via the --ddiirr option.  The --ddiirr option is intended
  162.      to be used under UNIX.  If you need to copy stuff  into  the
  163.      new  filesystem  under  Sprite  use the uuppddaattee command.  The
  164.      rest of the options are more complex and probably  not  used
  165.      often.   The  disk configuration, such as sectors per track,
  166.      tracks per cylinder, etc, can be  set  using  the  --rreeccoonnffiigg
  167.      option.  Don't use this option if the disk contains anything
  168.      you want to keep, since it may goof up the size and location
  169.      of  the  disk  partition.  If you don't specify the --ccoonnffiigg--
  170.      ddiisskkttaabb option then ffssmmaakkee will make up a configuration that
  171.      minimizes  wasted  disk space.  This only works under Sprite
  172.      and on SCSI disks.  The --rreeppaarrttiittiioonn allows  you  to  change
  173.      the partitioning of the disk.  The --ppaarrttddiisskkttaabb will set the
  174.      partitioning from the disktab file.  Once again,  don't  use
  175.      this option if there is valuable stuff on the disk since you
  176.      may lose it.  If you don't use the --ppaarrttddiisskkttaabb option  then
  177.      you  have  to  use  the  --ssiizzee option to set the size of the
  178.      current partition as a percentage of the  total  disk  size.
  179.      FFssmmaakkee  will adjust the start of all paritions that "follow"
  180.      the current one on the disk.  Note that  ffssmmaakkee  assumes  an
  181.      ordering  on the partitions, ie disk and 'b' is not used. If
  182.      you want to change the size of a bunch  of  partitions  then
  183.      run  ffssmmaakkee  on  the patritions in alphabetical order.  That
  184.      should do the right thing.  The  --rraattiioo  option  allows  you
  185.      change  the ratio of file system blocks to file descriptors.
  186.      Non-SCSI disks can have their  file  system  blocks  overlap
  187.      track  boundaries  by  specifying the --oovveerrllaapp option.  This
  188.      packs more blocks per cylinder.
  189.  
  190. FFssmmaakkee oonn UUNNIIXX
  191.      The ffssmmaakkee command can be run on a UNIX system to  create  a
  192.      Sprite  filesystem.   There are several differences in func-
  193.      tionality. First, ffssmmaakkee cannot make up a configuration  for
  194.  
  195.  
  196.  
  197. Sprite v.1.0         Printed:  June 13, 1991                    3
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204. FSMAKE                    User Commands                    FSMAKE
  205.  
  206.  
  207.  
  208.      the  disk.   The  configuration must be set from the disktab
  209.      file.  Second, the --ddiirr option uses a special mechanism  for
  210.      creating Sprite devices.  If ffssmmaakkee comes across a file with
  211.      the suffix "SPRITE_DEV" it is assumed to  be  a  placeholder
  212.      for  a  Sprite device.  The contents of the file specify the
  213.      device server, major number and minor  number.   Lines  that
  214.      are  blank  or  begin with '#' are ignored.  The file should
  215.      contain one line with three integers --  the  device  server
  216.      SpriteID, major number (device type), and minor number (dev-
  217.      ice unit).
  218.  
  219. KKEEYYWWOORRDDSS
  220.      filesystem
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263. Sprite v.1.0         Printed:  June 13, 1991                    4
  264.  
  265.  
  266.  
  267.